Node / meshtastic / Meshtastic-Android / files / feature / firmware / src / commonTest / kotlin / org / meshtastic / feature / firmware / ota / dfu / DfuFallbackCoordinatorTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tf0883e@fileTb4b4b4:Te6edf3OptInTb4b4b4(Te6edf3ExperimentalCoroutinesApiTff7b72::Te6edf3classTb4b4b4)

Tff7b72package T7ee787org.meshtastic.feature.firmware.ota.dfu

Tff7b72import T7ee787kotlinx.coroutines.ExperimentalCoroutinesApi

Tff7b72import T7ee787kotlinx.coroutines.test.runTest

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFailsWith

Tff7b72class T56d364DfuFallbackCoordinatorTest Tb4b4b4{

Tf0883e@Test

Tff7b72fun Td2a8ff`LegacyObserved tries Legacy first`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3LegacyObservedTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`SecureObserved tries Secure first`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3SecureObservedTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURETb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Unknown tries Legacy first`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3UnknownTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4) T8b949e// Success on first = no fallback

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Unknown falls back from Legacy to Secure on pre-engagement failure`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3UnknownTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3attemptCounts Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657IntTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3RuntimeExceptionTff7b72> Tb4b4b4{

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3attempts Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3attemptCountsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3attemptsTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3protocol Tff7b72=Tff7b72= Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4) Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6ffconnect failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72falseTb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6ffalso failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72falseTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3also Tb4b4b4{ Te6edf3thrown Tff7b72-Tff7b72>

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffconnect failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3messageTb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3suppressedExceptionsTb4b4b4.Te6edf3sizeTb4b4b4, Ta5d6ff"Ta5d6ffalternate error should be suppressed on primaryTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffalso failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3suppressedExceptionsTb4b4b4.Te6edf3firstTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3messageTb4b4b4)

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4, Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURETb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(T79c0ff1Tb4b4b4, T79c0ff1Tb4b4b4)Tb4b4b4, Te6edf3attemptCountsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`protocolEngaged prevents fallback`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3UnknownTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3RuntimeExceptionTff7b72> Tb4b4b4{

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6ffmid-transferTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72trueTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4) T8b949e// No fallback despite Unknown

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`LegacyObserved gives Legacy 3 session attempts`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3LegacyObservedTb4b4b4)

Tff7b72val Te6edf3attemptCounts Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657IntTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3_Tb4b4b4, Te6edf3attempts Tff7b72-Tff7b72>

Te6edf3attemptCountsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3attemptsTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(T79c0ff3Tb4b4b4)Tb4b4b4, Te6edf3attemptCountsTb4b4b4) T8b949e// LEGACY_SESSION_ATTEMPTS

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`LegacyObserved skips Secure fallback when Legacy never engages`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3LegacyObservedTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3RuntimeExceptionTff7b72> Tb4b4b4{

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6fflegacy connect failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72falseTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3also Tb4b4b4{ Te6edf3thrown Tff7b72-Tff7b72> Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6fflegacy connect failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3messageTb4b4b4) Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`LegacyObserved gives Secure fallback 1 session attempt after Legacy engages`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3LegacyObservedTb4b4b4)

Tff7b72val Te6edf3attemptCounts Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657IntTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3attempts Tff7b72-Tff7b72>

Te6edf3attemptCountsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3attemptsTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3protocol Tff7b72=Tff7b72= Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4) Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6fflegacy protocol failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72trueTb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(

Te6edf3listOfTb4b4b4(T79c0ff3Tb4b4b4, T79c0ff1Tb4b4b4)Tb4b4b4,

Te6edf3attemptCountsTb4b4b4,

Tb4b4b4) T8b949e// Legacy primary=LEGACY_SESSION_ATTEMPTS, Secure fallback=LIMITED_SESSION_ATTEMPTS

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Unknown gives Legacy primary 1 session attempt`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3UnknownTb4b4b4)

Tff7b72val Te6edf3attemptCounts Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657IntTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3_Tb4b4b4, Te6edf3attempts Tff7b72-Tff7b72>

Te6edf3attemptCountsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3attemptsTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(T79c0ff1Tb4b4b4)Tb4b4b4, Te6edf3attemptCountsTb4b4b4) T8b949e// LIMITED_SESSION_ATTEMPTS keeps speculative Unknown probes bounded

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`SecureObserved skips Legacy fallback when Secure never engages`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3SecureObservedTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3RuntimeExceptionTff7b72> Tb4b4b4{

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6ffsecure connect failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72falseTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3also Tb4b4b4{ Te6edf3thrown Tff7b72-Tff7b72> Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffsecure connect failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3messageTb4b4b4) Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURETb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`SecureObserved throws Secure error with Legacy suppressed when both fail`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3coordinator Tff7b72= Te6edf3DfuFallbackCoordinatorTb4b4b4(Te6edf3BootloaderDetectionTb4b4b4.Te6edf3SecureObservedTb4b4b4)

Tff7b72val Te6edf3protocols Tff7b72= Te6edf3mutableListOfTff7b72<Te6edf3DfuProtocolKindTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3RuntimeExceptionTff7b72> Tb4b4b4{

Te6edf3coordinatorTb4b4b4.Te6edf3execute Tb4b4b4{ Te6edf3protocolTb4b4b4, Te6edf3_ Tff7b72-Tff7b72>

Te6edf3protocolsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3protocolTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3protocol Tff7b72=Tff7b72= Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURETb4b4b4) Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6ffsecure protocol failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72trueTb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3DfuUploadResultTb4b4b4.Te6edf3FailureTb4b4b4(Te6edf3RuntimeExceptionTb4b4b4(Ta5d6ff"Ta5d6fflegacy also failedTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3protocolEngaged Tff7b72= Tff7b72falseTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3also Tb4b4b4{ Te6edf3thrown Tff7b72-Tff7b72>

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffsecure protocol failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3messageTb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3suppressedExceptionsTb4b4b4.Te6edf3sizeTb4b4b4, Ta5d6ff"Ta5d6ffalternate error should be suppressed on primaryTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6fflegacy also failedTa5d6ff"Tb4b4b4, Te6edf3thrownTb4b4b4.Te6edf3suppressedExceptionsTb4b4b4.Te6edf3firstTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3messageTb4b4b4)

Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURETb4b4b4, Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4)Tb4b4b4, Te6edf3protocolsTb4b4b4)

Tb4b4b4}

Tb4b4b4}